home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / tset.z / tset
Text File  |  1998-10-20  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. TTTTSSSSEEEETTTT((((1111))))                                                                TTTTSSSSEEEETTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      tset - terminal dependent initialization
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ttttsssseeeetttt [ options ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _T_s_e_t causes terminal dependent processing such as setting erase and kill
  16.      characters, setting or resetting delays, and the like.  It first
  17.      determines the _t_y_p_e of terminal involved, names for which are specified
  18.      by the /_u_s_r/_l_i_b/_t_e_r_m_i_n_f_o data base, and then does necessary
  19.      initializations and mode settings.  In the case where no argument types
  20.      are specified, _t_s_e_t simply reads the terminal type out of the environment
  21.      variable TERM and re-initializes the terminal.  The rest of this manual
  22.      concerns itself with type initialization, done typically once at login,
  23.      and options used at initialization time to determine the terminal type
  24.      and set up terminal modes.
  25.  
  26.      When used in a startup script ".profile" (for _s_h(1) users) or ".login"
  27.      (for _c_s_h(1) users), it is desirable to give information about the types
  28.      of terminal usually used, for terminals which are connected to the
  29.      computer through a modem.  These ports are initially identified as being
  30.      _d_i_a_l_u_p or _p_l_u_g_b_o_a_r_d or _a_r_p_a_n_e_t etc.  To specify what terminal type is
  31.      usually used on these ports, ----mmmm is followed by the appropriate port type
  32.      identifier, an optional baud-rate specification, and the terminal type to
  33.      be used if the mapping conditions are satisfied.  If more than one
  34.      mapping is specified, the first applicable mapping prevails.  A missing
  35.      type identifier matches all identifiers.
  36.  
  37.      Baud rates are specified as with _s_t_t_y(1), and are compared with the speed
  38.      of the diagnostic output (which is almost always the control terminal).
  39.      The baud rate test may be any combination of:  >>>>, ====, <<<<, @@@@, and !!!!; @@@@ is a
  40.      synonym for ==== and !!!! inverts the sense of the test.  To avoid problems
  41.      with metacharacters, it is best to place the entire argument to ----mmmm within
  42.      '' characters; users of _c_s_h(1) must also put a "\" before any "!" used
  43.      here.
  44.  
  45.      Thus
  46.  
  47.           tset -m 'dialup>300:adm3a' -m dialup:dw2
  48.  
  49.      causes the terminal type to be set to an _a_d_m_3_a if the port in use is a
  50.      dialup at a speed greater than 300 baud; to a _d_w_2 if the port is
  51.      (otherwise) a dialup (i.e., at 300 baud or less).  If the _t_y_p_e above
  52.      begins with a question mark, the user is asked if the user really wants
  53.      that type.  A null response means to use that type; otherwise, another
  54.      type can be entered which will be used instead.  For other ports the port
  55.      type will be taken from the ////eeeettttcccc////ttttttttyyyyttttyyyyppppeeee file or a final, default _t_y_p_e
  56.      option may be given on the command line not preceded by a ----mmmm.  A ttytype
  57.      may be preceded with a question mark in ////eeeettttcccc////ttttttttyyyyttttyyyyppppeeee for prompting (this
  58.      is an enhancement over standard _t_s_e_t).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTSSSSEEEETTTT((((1111))))                                                                TTTTSSSSEEEETTTT((((1111))))
  71.  
  72.  
  73.  
  74.      It is often desirable to return the terminal type, as specified by the ----mmmm
  75.      options, and information about the terminal to a shell's environment.
  76.      This can be done using the ----ssss option; using the Bourne shell, _s_h(1):
  77.  
  78.           eval `tset -s options ... `
  79.  
  80.      or using the C shell, _c_s_h(1):
  81.  
  82.           tset -s options ... > tset$$
  83.           source tset$$
  84.           rm tset$$
  85.  
  86.      These commands cause _t_s_e_t to generate as output a sequence of shell
  87.      commands which place the variable TERM in the environment; see
  88.      _e_n_v_i_r_o_n(4).
  89.  
  90.      Once the terminal type is known, _t_s_e_t engages in terminal mode setting.
  91.      This normally involves sending an initialization sequence to the terminal
  92.      and setting the single character erase (and optionally the line-kill
  93.      (full line erase)) characters.
  94.  
  95.      On terminals that can backspace but not overstrike (such as a CRT), and
  96.      when the erase character is the default erase character (``#'' on
  97.      standard systems), the erase character is changed to a ^H (backspace).
  98.  
  99.      Other options are:
  100.  
  101.      ----eeee  set the erase character to be the named character _c on all terminals,
  102.          the default being the backspace character on the terminal, usually
  103.          ^H.
  104.  
  105.      ----kkkk  is similar to ----eeee but for the line kill character rather than the
  106.          erase character; _c defaults to ^X (for purely historical reasons); ^U
  107.          is the preferred setting.  No kill processing is done if ----kkkk is not
  108.          specified.
  109.  
  110.      ----hhhh  do not read the terminal type from the environment variable TERM.
  111.  
  112.      ----IIII  suppresses outputting terminal initialization strings.
  113.  
  114.      ----QQQQ  suppresses printing the ``Erase set to'' and ``Kill set to''
  115.          messages.
  116.  
  117.      ----SSSS  Outputs just the strings to be assigned to TERM rather than commands
  118.          for a shell.
  119.  
  120. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  121.      A typical _c_s_h ".login" file using _t_s_e_t would be:
  122.  
  123.           set noglob
  124.           set tmp = `tset - -m dialup:?h19 -Q`
  125.           setenv TERM "$tmp[1]"
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTSSSSEEEETTTT((((1111))))                                                                TTTTSSSSEEEETTTT((((1111))))
  137.  
  138.  
  139.  
  140.           unset tmp noglob
  141.  
  142.      This ".login" sets the environment variable TERM for the user's current
  143.      terminal according to the file /_e_t_c/_t_t_y_t_y_p_e . If the terminal line is a
  144.      dialup line, the user is prompted for the proper terminal type.
  145.  
  146. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  147.      tset determines which set of commands to use (setenv vs export) by
  148.      looking at the SSSSHHHHEEEELLLLLLLL environment variable when the ----ssss option is given.
  149.      This is not a problem at login, but for testing shell's other than one's
  150.      normal shell, it may be necessary to change the SSSSHHHHEEEELLLLLLLL variable in your
  151.      environment.
  152.  
  153. FFFFIIIILLLLEEEESSSS
  154.      /etc/ttytype          terminal id to type map database
  155.      /usr/lib/terminfo     terminal capability database
  156.  
  157. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  158.      csh(1), sh(1), stty(1), environ(4), ttytype(4), terminfo(4).
  159.  
  160. NNNNOOOOTTTTEEEESSSS
  161.      For compatibility with earlier versions of _t_s_e_t, a number of flags are
  162.      accepted whose use is discouraged:
  163.  
  164.      ----dddd type   equivalent to ----mmmm dialup:type
  165.  
  166.      ----pppp type   equivalent to ----mmmm plugboard:type
  167.  
  168.      ----aaaa type   equivalent to ----mmmm arpanet:type
  169.  
  170.      ----EEEE c      Sets the erase character to _c only if the terminal can
  171.                backspace.
  172.  
  173.      ----         prints the terminal type on the standard output
  174.  
  175.      ----rrrr        prints the terminal type on the diagnostic output.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.